Mac Format 1994 August/August CD.bin/Shareware/Utilities/Maybe 1.3/Maybe Help/Maybe Help.rsrc/STR#_1029.txt

Text File | 1994-04-01 | 25KB | 1,580 lines

recently.

Maybe spares you the balloon, figuring that you’ve probably seen enough

Balloon Help and Help on Wheels.  If you already have balloons showing,

It mentions, by way of a balloon, that Maybe offers help through both





Maybe…” command in the Apple menu.

This dialog presents Maybe’s About box.  It is opened by the “About




xThe About Dialog









to clicking Yes.

you can press Return or Enter instead.  Pressing ‘y’ or ‘+’ is equivalent

default response as defined in the Options dialog for the converted alias,

Click here to tell Maybe to open or print the target item.  If this is the



•  Yes







Control-Period is equivalent to clicking No.

you can press Return or Enter instead.  Pressing ‘n’, ‘-’, Escape, or

default response as defined in the Options dialog for the converted alias,

Click here to tell Maybe not to open or print the target item.  If this is the



•  No





resource from 2048 to 2063.

have a resource editor, change the ProcID field of Maybe’s 'CNTL'(128)

windows, so you may want to turn off the animation.  To do this, if you

causes other applications such as Finder to erase and redraw their

actually sweep down the seconds.  Unfortunately, the timer animation

NOTE:  On a monitor set to 256 grays or colors, the countdown timer will





before the user chooses “Yes” or “No,” the default response is assumed.

can stop and start the timer by clicking on its face.  If the timer elapses

It starts at the wait time limit and works down toward zero.  The user

countdown timer, rather like the one you see in a motion picture leader.

If the options specify a wait time, Maybe makes room for a circular



•  Countdown timer





text was supplied, Maybe will compose some appropriate question.

This dialog displays the text supplied using the Alert Text option.  If no





time is not zero, Maybe posts the Prompt dialog.

Alert User action type, and the Command key is not pressed, and the wait

When Finder asks Maybe to open or print a converted alias which has the



◊

◊

◊

◊


◊

◊

◊


◊

◊

◊

◊

◊

◊

◊

◊

◊


◊




xThe Prompt Dialog









Sound dialog.

Click here to place the sound in the selected file and close the Action



•  OK







Sound dialog.

Click here to avoid placing the new sound in a file and return to the Action



•  Cancel







file.

file is unwritable.  The default is to place the sound in the converted alias

will be placed.  The preferences file button is disabled if the preferences

Click one of the two radio buttons to choose which file where the sound



•  Place Sound In







number in this box.

several Macintoshes, there is no need to change the randomly generated

converted alias.  Unless you need to coordinate sound numbers between

because it’s how Maybe remembers the sound you have chosen for a

displayed in the Action Sound dialog’s list box.  The number is important,

Enter a number between 128 and 32767 in this box.  This number will be



•  Number







displayed in the Action Sound dialog’s list box.

Optionally, you may enter a sound name in this box.  This name will be



•  Name







dialog appears.

file.  If you don’t want to hear the sound, hold down the Option key as the

decide whether to put it in the converted alias file or in the preferences

dialog.  This is where you assign a name and number to the new sound, and

Clipboard, or after recording a new sound, while using the Action Sound

The Sound Name dialog appears when you ask to paste a sound from the



Õ

Õ

Õ


Õ

Õ

Õ

Õ

Õ

Õ

Õ

Õ

Õ


Õ




xThe Sound Name Dialog









the sound, hold down the Option key as the Sound Name dialog appears.

Click here to proceed to the Sound Name dialog.  If you don’t want to hear



•  Save







dialog.

Click here to avoid recording a sound and return to the Action Sound



•  Cancel







click Save.

different sounds together.  Nothing is actually saved to disk before you

tape recorder.  You can use the Pause button during recording to splice

Click these buttons to control recording and playback, as you would on a



•  Record, Stop, Pause, Play





memory size to hear large sounds.

not necessary for users of converted aliases to increase Maybe’s

sound you want to record, quit Maybe and increase its memory size.  It is

If you find that the dialog does not offer enough recording time for the





click Record Sound Into… in the Action Sound dialog.

This is the standard Macintosh Record Sound dialog.  It appears when you



‚àö

‚àö

‚àö

‚àö

‚àö

‚àö

‚àö

‚àö


‚àö




xThe Record Sound Dialog









Click here to accept the action sound choice and close the dialog.



•  OK







dialog.

not affect any changes made to files containing sounds while using the

Click here to cancel the action sound choice and close the dialog.  This will



•  Cancel







disabled if there is no sound input device available.

dialog that follows, this will close the Action Sound dialog.  This button is

control panel.  Unless you cancel in the Record Sound dialog or Sound Name

preferences file, using the sound input device selected in the Sound

Click this button to record a sound into the converted alias file or



•  Record Sound Into…







This button is disabled if there is no sound in the Clipboard.

if you do not wish to hear the sound as the Sound Name dialog appears.

that follows, this will close the Action Sound dialog.  Press the Option key

alias file or preferences file.  Unless you cancel in the Sound Name dialog

Click this button to paste a sound from the Clipboard into the converted



•  Paste Sound Into… (Command-V)







unwritable file.  Pressing Delete is equivalent to clicking Clear Sound.

You are not allowed to clear a sound from the System file, nor from any

Click this button to clear the selected sound, removing it from its file.



•  Clear Sound







Click this button to copy the selected sound to the Clipboard.



•  Copy Sound (Command-C)







nor from any unwritable file.

from its file.  You are not allowed to cut a sound from the System file,

Click this button to cut the selected sound to the Clipboard, removing it



•  Cut Sound (Command-X)





This option is off by default.





play.

the option, Maybe will cut off the playing sound if it has another sound to

be played as another converted alias is opened or printed.  If you turn off

such as voice messages, to the end, even if that holds up the next sound to

printed.  If you turn on this option, the user will always hear long sounds,

play the sound to completion when the converted alias is opened or

If any sound is selected in the list, you have an option of whether or not to



•  Always Play Sound to Completion option





sound to be played.  This is the default.

The top line in the list box says “[none]”.  Click this line if you want no





want to hear the sound, hold down the Option key as you click.

sound and select it, or double-click to hear it and choose it.  If you don’t

a Finder alias file, and Finder will ignore it.)  Click any line to hear the

using Maybe, it will stick with the alias even after it has been reverted to

(Normally, a Finder alias file does not contain sounds, but if you add one

Maybe itself, the Maybe Preferences file, and the Finder alias file.

This list box contains one line for every sound found in the System file,



•  Sound list box







alias is opened or printed, just before the action takes place.

Sound dialog.  This is where you select a sound to play when the converted

Clicking the Action Sound… button in the Options dialog opens the Action



π⌥

π⇧

π⌘

π

π

π

π


π

π

π


π

π

π

π

π

π

π

π

π


π




xThe Action Sound Dialog







If any options are invalid, you are prompted to correct them.





converted alias.

conversion of a Finder alias file or the changing of options in an existing

Click here to accept the options and close the dialog.  This will lead to the



•  OK





If any options are invalid, you are prompted to correct them.





pads.

the dialog.  You may or may not prefer this approach to using stationery

Click here to change the default values for all options to those displayed in



•  Make Defaults







described in this help file.

key pressed to change all options to their built-in default values, the ones

have changed using Make Defaults (see below).  Click here with the Option

Click here to change all options to their default values, which you may



•  Use Defaults







changes made to an existing converted alias.

Click here to cancel the conversion of a Finder alias file, or to cancel the



•  Cancel





See the section entitled “The Action Sound Dialog” for more information.



Sound dialog.

To change this, you click the Action Sound… button to bring up the Action

By default, no sound is played when a converted alias is opened or printed.



•  Action Sound… option





This option is off by default.





that isn’t a stationery pad.

stationery pad using Finder, but it wouldn’t look any different from one

you don’t use this option, you could change the converted alias to a

stationery pad, and alter the brand icon slightly to reflect that fact.  If

When this option is in effect, Maybe will make the converted alias into a



°  Stationery option





This option is on by default.





rate, you can always change the name after converting the alias.

branding the icon, but is more likely to be noticed in file dialogs.  At any

the alias file as it is converted.  This accomplishes the same effect as

When this option is in effect, Maybe will suffix “ (Maybe)” to the name of



°  Convert File Name option





This option is on by default.





Preferences file, if any.

fills the question mark is tinged according to the label color of the Maybe

it is not a normal alias file and not the original.  The grayish color which

garish question mark stamped over the former icon, to make it clear that

When this option is in effect, the converted alias will sport a rather large,



°  Brand Icon option







At other times, when changing options, they are unavailable.

converted alias.  They are available only at the time of initial conversion.

The following three options affect the appearance of the resulting



•  Appearance options





The default is to open the window.



Maybe documents, which are opened or printed in turn.

ask Finder to open or print each item in the folder.  The folder may contain

print a folder.)  If you choose the Open/Print Each Item option, Maybe will

folder’s window, showing the icons inside.  (It is an error to ask Finder to

If you choose the Open Window option, Maybe will ask Finder to open the





or print it.

volume, which is equivalent for this purpose) until it has decided to open

Maybe doesn’t know whether or not the target item is a folder (or



•  Folder Treatment option





The “default” default response is “No.”



For the None action type, the default response is always assumed.



timer elapses.  It is an error if the other item does not exist.

For the Open Item action type, the default response is assumed if the



program does not exist, or if the timer elapses.

For the Send AE action type, the default response is assumed if the target



indication.

conditions are not met.  If they are met, Maybe takes the opposite

For the Check Keys action type, the default response is assumed if the key



clicked if the timer elapses.

button gets the thick outline, the one which is assumed to have been

For the Alert User action type, the default response determines which





other indication.

determines whether or not to open or print the target item, if there is no

Every action type can have a default response, “Yes” or “No,” which



•  Default Response option







Command-Period at any time to cancel the wait.

Click this button to wait indefinitely for a response.  You can still press



°  Forever option







the Alert if Wait Elapses option.

reply to an Apple event, you should set the wait time to zero and turn off

background after opening the other item.  If you are not interested in the

but Maybe won’t wait for a reply; for Open Item, Maybe won’t wait in the

dialog will not come up; for Send AE, the Apple event will still be sent,

zero, the effect depends on the action type:  for Alert User, the Prompt

enter the number of seconds in the text field.  If you set this number to

Click this button to limit the time Maybe will wait for a response, then



°  Up to … Seconds option





default time limit is 5 seconds.

The default is to wait forever, but if you click the other button, the





Item action.  These buttons are disabled for other action types.

determines how long Maybe will wait in the background during an Open

wait for a response to an Alert User or Send AE action.  This choice also

Choose one of these two radio buttons to indicate how long you want to



•  Wait for Response option





the folder treatment or action sound option permanently to an alias.

target item through the converted alias.  You might also use it to attach

You can use this action type to temporarily “shut down” access to the





sound will still play.

is opened or printed, special folder treatment is still given, and any action

the default response option will determine whether or not the alias target

or print the converted alias, but other options still apply.  In particular,

If you choose this action type, no special action will occur when you open



•  None action option





effect.

when you click the Item… button, you will see a warning alert to that

NOTE:  If you have already chosen an item, and that item cannot be found



converted aliases together.

The item can be another converted alias, if you want to chain two or more





opening it, and to select an alias file instead of its target.

“item””.  You can use this button to select a volume or folder instead of

dialog which appears has an extra button at the bottom, marked “Select

Click the Item… button to see or choose the other item to open.  The file



°  Item… option





come up.)

requires, it would be wise to allow a 45-second wait for the connection to

up an AppleTalk Remote Access connection which the target item

until the mount completes.  However, if your other item intends to bring

time to zero, because Finder will not get around to opening the target item

depend on a certain remote volume being mounted, you can set the wait

alias to a remote server as the other item, so that the target item can

will then open or print the target item.  (For example, if you are using an

you make it active.  If Maybe becomes active before the timer elapses, it

Maybe will wait in the background, blinking its icon in the menu bar, until

opened or printed immediately after opening the other item.  Otherwise,

elapses.  Set the wait time to zero if you want the target item to be

The default response will be assumed if you specify a wait time and it





you set the options.

The other item can be local or on any volume which is mounted at the time

information, so that it won’t lose track of it if it is moved or renamed.

records the identity and location of this other item using alias

(not printed) just before the target item is opened or printed.  Maybe

folder, application, document, alias, or whatever) which will be opened

If you choose this action type, you can choose another item (volume,



‚â•

‚â•

‚â•


‚â•



•  Open Item action option





This option is on by default.





assume the default response.

box to tell you so.  Otherwise, it will not.  In either case, Maybe will

target program fails to reply within that time, Maybe will put up a dialog

If this option is in effect, and you have specified a wait time, and the



°  Alert If Wait Elapses option





This option is on by default.





open or print the target item.

text of the dialog.)  Otherwise, it will not.  In either case, Maybe will not

up a dialog box to tell you so.  (If there is an error string, it will form the

error string when the converted alias is opened or printed, Maybe will put

If this option is in effect, and the target program returns an error code or



°  Alert If Target Reports Error option





This option is on by default.





default response.

you so.  Otherwise, it will not.  In either case, Maybe will assume the

converted alias is opened or printed, Maybe will put up a dialog box to tell

If this option is in effect, and the target program does not exist when the



°  Alert If No Target option





near the point of the error.

Maybe will report any syntax errors it finds, and place the text cursor



See the picture above for an example of this syntax.

See the attached documentation on AEBuild for full syntax details.





“'----':value” (without the double quotes).

parameter, please remember to put single quotes around the key, thus:

and values in AEBuild format.  If one of your parameters is the direct

parameters, you must enter them here as a comma-separated list of keys

blank.  If it requires parameters, or you want to supply optional

Apple event, as Quit Application does, then you should leave this field

If the Apple event registry information specifies no parameters for the



°  AE Text option





for you to bring it back to the front.  Maybe strives to be polite.

is that if Maybe wants to report an error, it has to say “ahem” and wait

before it receives the Apple event.  The disadvantage to using this option

can set the activate option, to force the application to become active

If you find that the target program doesn’t “play by the rules,” then you





if you want to save the file, but the dialog comes up in the background.

modified file open, and you send it a Quit Application event, it will ask you

click on it before you can answer it.  For example, if ResEdit 2.1.1 has a

this, then the dialog will come up in the background, and you will have to

to that application so that you can answer the dialog.  If it does not do

event.  If the target application does this, Maybe will automatically yield

user interaction” before putting up a dialog box in response to an Apple

The standard practice for Apple-event-aware applications is to “request



°  Activate option







“quit” (without the double quotes).

want to send.  For example, for a Quit Application event, you would enter

Enter the four-character Apple event ID code for the Apple event you



°  ID option







“aevt” (without the double quotes).

want to send.  For example, for a Quit Application event, you would enter

Enter the four-character Apple event class code for the Apple event you



°  Class option





name from the list under Macintoshes.

programs running on your machine.  To correct this, select a machine

disconnected from its network, because it looks as though there are no

under Programs.  This is a bit misleading, especially if your machine is

the target machine which could not be found, it will show an empty list

alert to that effect.  When the program browser dialog appears, if it was

cannot be found when you click the Target… button, you will see a warning

NOTE:  If you have already chosen a target program, and that program



program linking through its Finder Sharing dialog.

& Groups control panel, and the target program must allow remote

your user name must be allowed to do program linking through the Users

must have program linking turned on in the Sharing Setup control panel,

Remember that in order for program linking to work, the target machine





list of programs.

network, you can choose any zone and any machine, then select from its

programs which are running at this time.  If you are connected to a

Apple event.  It brings up a program browser dialog, listing all “linkable”

Click the Target… button to choose a program which will receive the



°  Target… option





will beep to confirm, and will not open or print the target item.

item.  Also, if you cancel the wait by pressing Command-Period, Maybe

server returns any sort of error, Maybe will not open or print the target

(server) can’t be found, either locally or through the network.  If the

target program doesn’t respond within that time, or if the target program

The default response will be assumed if you specify a wait time and the





figure out what is wrong.

program.  Sometimes, you may need a list of Apple event error codes to

telling you the error string or error number returned by the target

get it wrong the first time, Maybe can tell you what the problem is by

you to determine what Apple events that program will accept, but if you

address it to any program on any Macintosh on your network.  It is up to

If you choose this action type, you can compose a single Apple event and



≤

≤

≤

≤

≤

≤


≤



•  Send AE action option







Down… option.

to override the default.  The procedure is the same as for the Keys

Click the Keys Up… button to choose which keys must be up (not pressed)



°  Keys Up… option







was recorded.

combination.  The Options dialog gives you feedback so you can check what

keys are sometimes truncated, because the keyboard can’t report that

limitations of the keyboard design, you may find that sets of four or more

down all the keys you want in this set, and click the OK button.  Due to

(pressed) to override the default.  When the Keys dialog comes up, hold

Click the Keys Down… button to choose which keys must be down



°  Keys Down… option





combination of keys and not certain others.

The default response will be assumed unless the user presses a certain





time.

or print the target item depending on the state of the keyboard at the

If you choose this action type, Maybe will decide whether or not to open



±

±

±

±


±



•  Check Keys action option







that a “Yes” answer means don’t open the target item.

want to abort?” would be wrong, because Maybe would not understand

phrased in the positive.  For example, “This looks dangerous.  Do you

Item”?”  You can put any text you choose in this field, as long as it is

display in the dialog box, along the lines of, “Do you want to open “Target

If you leave this field blank, then Maybe will compose the message to



°  Alert Text option





needed, the user can stop the countdown timer by clicking on it.)

Enter key, or if you specify a wait time and it elapses.  (If more time is

The default response will be assumed if the user presses the Return or





the Prompt dialog.

See the section entitled “The Prompt Dialog” for more information about

the target item.

answer.  Only if the answer is “Yes” does Maybe proceed to open or print

opening or printing the converted alias, asking for a “Yes” or “No”

If you choose this action type, the user will see the Prompt dialog when



‚àû

‚àû

‚àû

‚àû

‚àû


‚àû



•  Alert User action option







to select an option.

converted alias is opened or printed.  Click one of these five radio buttons

This version of Maybe offers five choices of action to perform when the



•  Action option







you ask to change the options in a converted alias.

This dialog appears when you are converting a Finder alias file, and when



√ò‚áß

√ò‚åò

√ò

√ò

√ò

√ò


√ò

√ò

√ò


√ò

√ò

√ò

√ò

√ò

√ò

√ò

√ò

√ò


√ò




xThe Options Dialog









described here.

Maybe does not open any windows other than dialog boxes, which are








åDialogs


§



§